Getting started

Refer to the following sections below to get started with the integration.

Supported configurations

Thales has tested this integration with the versions of Apache Tomcat shown below.

Apache Tomcat 10.0.14

Thales has tested integration with Apache Tomcat 10.0.14 using the configurations shown in the table below.

Apache Tomcat 9.0.56

Thales has tested integration with Apache Tomcat 9.0.56 using the configuration shown in the table below.

Setting up your environment for the integration

Before beginning the integration, you must set up your environment for the integration.

To set up your environment for the integration

1. Install one of the supported operating systems on the client machine. Refer to Supported configurations for more information.

2. Set up, initialize, provision, and prepare a ProtectServer 3 HSM for deployment. Refer to ProtectServer 3 HSM and ProtectToolkit 7 installation and configuration for more information.

3. Install ProtectToolkit 7 on the client machine. Refer to ProtectToolkit 7 software installation for more information.

4. Configure the ProtectServer 3 HSM for the integration.

   1. Create a slot on the HSM that will be used by Tomcat. Refer to Adding and removing slots for more information.

   2. Verify that the the HSM is successfully configured by running hsmstate.

      C:\Users\Administrator>hsmstate
      HSM device 0:   HSM in NORMAL MODE. RESPONDING. Usage Level=0%
      
      C:\Users\Administrator>ctkmu l
      ProtectToolkit C Key Management Utility 7.0.0
      Copyright (c) Safenet, Inc. 2009-2021
      Cryptoki Version  = 2.20
      Manufacturer      = Safenet, Inc.
      Test                             (Slot 0)
      AdminToken (524128)              (Slot 1)
      
      C:\Users\Administrator>
      

5. Install the Java Development Kit (JDK). You can run the commands in this instruction set wherever you have the keytool command available.

6. Install and set up Apache Tomcat. For more information, refer to the installation procedures described in the Apache Tomcat Product Documentation.

   Note

   After installing Tomcat, ensure that it is running successfully by accessing https://<hostname or IP address>:8080/